home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / cnet / FPAv223.lha / FPAV / FPAView.doc < prev   
Text File  |  1995-02-21  |  21KB  |  513 lines
  1.  
  2.                            FPAView v2.23 by PMK.
  3.                     Flux Point Amiga BBS  +45 3526 2527
  4.                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6.  
  7. Overview:
  8. ~~~~~~~~~
  9.  
  10. FPAV (Flux Point Archive Viewer) allows the user online to view or get info on
  11. ANY TYPE of file that is WITHIN any .LHA, .LZH , .RUN or .ZIP archive.
  12. It should work on multinode systems, but let me know if it's not so!!
  13.  
  14. NOTE: It only supports .LHA and .ZIP archives. Because on my BBS, all Amiga
  15.       files gets transformed to .LHA, and PC files to .ZIP. If anyone needs
  16.       a version for other archivers, then let me know!
  17.  
  18.  
  19.  
  20. Copyright:
  21. ~~~~~~~~~~
  22.  
  23.                               Postcards?
  24.                               ==========
  25.  
  26.      I'm not some starving student eager to get all you got, but knowing,
  27.     that my program is being used really makes me happy (and my ego, too!)..
  28.  
  29.      This program is 'Postcardware' - so if you find this program useful,
  30.     you MUST send me a postcard!  It should be addressed to:
  31.  
  32.                          Peter Klein
  33.                          Visbygade 4 3tv.
  34.                          2100 Copenhagen Ø
  35.                          Denmark
  36.  
  37.  
  38.    Since only a few people have send me the REQUIRED postcard, I won't be
  39.    making anymore public updates of this program or answer any questions
  40.    relating to the setup of FPAV.
  41.    ("registered" users can still get new updates directly from my BBS)
  42.  
  43.  
  44.      Thanks to the following people who DID send the REQUIRED postcard:
  45.  
  46.   Ivan Wheelwright    The Attic BBS        (+61)  8-384-4762   Australia
  47.   Michael Rudolph     Star Streams BBS     (+1) 214-938-7115   United States
  48.   Dan Hiner           Leisure World BBS    (+1) 713-859-0902   United States
  49.   Tom Björk           AmigaLINK BBS        (+46)  1-831-4644   Sweeden
  50.   Eduardo Torres      Micro-Users BBS      (+1) 809-744-7170   Puerto Rico
  51.   Erik Boersting      Nemesis Amiga BBS    (+45)   7535-3726   Denmark
  52.   Ken Hood            Phantasy Island BBS  (+44)  482-809845   United Kingdom
  53.   Roy Rennerholm      Digital Hangover BBS (+46)  8-607-4223   Sweeden
  54.   Charles Johnson     The Upper Room BBS   (+1) 602-771-8971   United States
  55.   Ed Cosner           Microbuffs BBS       (+1) 605-923-4770   United States
  56.  
  57.  
  58.  
  59.     FPAV is NOT is the PUBLIC DOMAIN.  You can however freely distribute
  60.     it as long as the following is observed:
  61.  
  62.     - The program and documentation must be distributed together
  63.       and may not be modified in any way.  The only exception is that the
  64.       program and documentation may be compressed into an archive for
  65.       uploading to Bulletin Boards or for other electronic transmission.
  66.  
  67.     - The program is not to be used commercially or included in a commercial
  68.       package for profit unless written authorisation from me is obtained
  69.       first.  This version of FPAV may be freely included on public domain
  70.       library disks or compilation disks provided only a small fee is
  71.       charged for the service.
  72.  
  73.  
  74.      There is no warranty for the programs, to the extent permitted by
  75.     applicable law.  Except when otherwise stated in writing the copyright
  76.     holders and/or other parties provide the programs "as is" without
  77.     warranty of any kind, either expressed or implied, including, but not
  78.     limited to, the implied warranties of merchantability and fitness for
  79.     a particular purpose.  The entire risk as to the quality and
  80.     performance of the programs is with you.  Should the programs prove
  81.     defective, you assume the cost of all necessary servicing, repair or
  82.     correction.
  83.  
  84.      In no event unless required by applicable law or agreed to in
  85.     writing will any copyright holder, or any other party who may
  86.     redistribute the programs as permitted above, be liable to you for
  87.     damages, including any general, special, incidental or consequential
  88.     damages arising out of the use or inability to use the programs
  89.     (including but not limited to loss of data or data being rendered
  90.     inaccurate or losses sustained by you or third parties or a failure of
  91.     the programs to operate with any other programs), even if such holder
  92.     or other party has been advised of the possibility of such damages.
  93.  
  94.  
  95.  
  96. User Commands.
  97. ~~~~~~~~~~~~~~
  98.  
  99. Input is in numeric form (CNet style) 
  100.  
  101.   1        View file 1   
  102.  
  103.   1-6      View files 1,2,3,4,5,6
  104.  
  105.   1,3!     View file 1 and 3 in Quick Mode.
  106.  
  107.    -       View ALL files in the archive!
  108.  
  109.    ?       Show help screen.
  110.  
  111. or combinations like this:  
  112.  
  113.   1,4,7-11  View files 1,4,7,8,9,10,11
  114.   
  115. If the file is a TEXT file, it will be displayed on the screen. FPAV has an
  116. option, so that the Sysop can select which access groups that have access to
  117. view complete TEXT files. The remaining access groups will only be able to 
  118. view 3K of the text, then they get a message saying that they should download
  119. the archive if the want to read more!
  120. If the file is an EXECUTABLE, FPAV will try to extract the version info of
  121. that file.
  122. If the file is another archive (.LZH, .LHA or .ZIP only) it will then show the
  123. contents of that archive, and the user can then select the files he wants to
  124. view, from that archive. (NOTE: Returning back to the previous archive, and
  125. resume viewing, is not possible, when viewing an archive inside another
  126. archive.)
  127. If the file is NOT TEXT, ARCHIVE or EXECUTABLE, then FPAV will try to identify
  128. the file, and show some info on it.  
  129.  
  130. As of v2.0 FPAV now has several new options available:
  131.  
  132.  -Module Playing! (LOCAL Mode Only!)
  133.  -IFF Sound Playing! (LOCAL Mode Only!)
  134.  -Viewing of: IFF/GIF/PCX/JPEG and ANIMS! (LOCAL Mode Only!)
  135.  -Re-displaying the archive after Adding/Killing or Viewing items!
  136.  -Build-in Helpscreen (Shows the commands available to user)
  137.  -Info on .GIF files (More to come!)
  138.  
  139.  
  140. SysOp Commands:
  141. ~~~~~~~~~~~~~~~
  142.  
  143. If the user has SysOp access, 3 more options are available:
  144.  
  145.   A  Add a file to the archive.      (You can change the var RMO in the
  146.                                      FPAV.rexx to get this to work in LOCAL
  147.                                      mode ONLY!)
  148.  
  149.   D  Download files from archive.    (Dosn't display any text/info on the
  150.                                      file. If the user is local, the program
  151.                                      will prompt for a path to copied to.)
  152.  
  153.   K  Kill (delete) files from archive. (Use this with CARE!!)
  154.  
  155.  
  156. NOTE: If the line is terminated with an '!', the SysOp options will skip the
  157.       yes/no prompts, just like CNet!
  158.  
  159. NOTE: Adding or Killing files to/from archives WITHIN another archive is NOT
  160.       POSSIBLE!
  161.       The archive size in CNet stays the same after Killing or Adding files
  162.       to/from an archive. - Use TR(ansform) on the archive to update the
  163.       archive size!
  164.  
  165.  Here's a few examples!
  166.  
  167.   A               Enter Add mode. A new prompt asks for the Path/File to add.
  168.  
  169.   D1,5-7          Download files 1,5,6,7 and 8.
  170.  
  171.   K1,5            Kill (delete) files 1 and 5. (with yes/no prompt.)
  172.  
  173.   K1,5!           Kill (delete) files 1 and 5. (without yes/no prompt.)
  174.  
  175.  
  176. Installation:
  177. ~~~~~~~~~~~~~
  178.  
  179.  
  180. 1) Makedir pfiles:FPAV
  181.  
  182.  
  183. 2) Copy the FPAV.rexx and FPAView.rexx to the pfiles:FPAV/ directory. Copy the
  184.    files in the UTILS directory to your System Partition (DH0:)
  185.  
  186.    NOTE: You also need the Xpk libraries to get the decrunching of Xpk packed
  187.          files! If you want to play the full range of mods using DeliTracker,
  188.          then you need some DeliPlayers too. These are not included in this
  189.          archive, but should be available on most large PD boards!
  190.          (Also required is LhA, Zip and Unzip)
  191.  
  192. 3) Load CONFIG, and select 'Archivers...' Then edit the 'View format' entry
  193.    for .LHA, .LZH, .RUN and .ZIP to look EXACTLY like this:
  194.  
  195.              rx pfiles:FPAV/FPAView.rexx %s "%s"
  196.  
  197. 4) If you want the Local option of viewing unpacked pictures, then repeat
  198.    step 3, for .IFF, .GIF, .JPG, .PCX, .ANI (If you doesn't have these in your
  199.    setup, then create these, the only option that needs to be set is the 
  200.    'View format'!
  201.  
  202. 5) Find line 1067 of your bbstext file. (looks like this in stock bbstext)
  203.  
  204.         \n1NOTE: can not find "%s" ...\n1
  205.         ^                             ^    
  206.     Control-Y                     Control-Y
  207.  
  208.  
  209.    Now change it so it reads:
  210.  
  211.         {#0PFiles:FPAV/FPAV.rexx %s}
  212.         ^
  213.     Control-Q
  214.  
  215.  
  216. 6) Reload CNet Text/Menu. and you are ready to use FPAV!!
  217.    Now, whenever a user uses the E(xtract) command on a .LHA, .LZH, .RUN or 
  218.    .ZIP file, they will get an archive listing as usual, but at the end of the
  219.    listing, there will be a prompt so the users can select if they want to
  220.    read or get info on some of the files in the archive.
  221.  
  222.  
  223.  
  224. Configuration:
  225. ~~~~~~~~~~~~~~
  226.  
  227. Load the file FPAV.rexx into an editor, and locate this area:
  228.  
  229. local=1        /* Mod Playing/Pic Viewing in local mode?   0=Disable 1=Enable  */
  230. rmo=0       /* Allow remote Sysop to use the Add to archives?  0=No 1=Yes   */
  231. fmem=200    /* How much MEM should ALWAYS be available to the system? (Kb)  */
  232. maxsz=3000  /* How much of a text may a 'lamer' see, before break? (bytes)  */
  233. lamers=' 0 1 2 3 4 5 18 ' /* Access groups that may only see <maxsz> test   */
  234. dag=' 20 27 28 29 '       /* Access groups that may Download from archives  */
  235. spl='PlaySound'           /* IFF Sound player.  */
  236. avi='PPShow NOFLICKER'    /* IFF Anim  player.  */
  237. ivi='PPShow NOFLICKER'    /* IFF Pic viewer.    */
  238. gvi='PPShow NOFLICKER'    /* GIF Pic viewer.    */
  239. pvi='VT'                  /* PCX Pic viewer.    */
  240. jvi='PPShow NOFLICKER'    /* JPEG Pic viewer.   */
  241. guv='MultiView'           /* AmigaGuide viewer. */
  242.  
  243.  
  244. The 1st line:
  245.  
  246.   local=1  /* Mod Playing/Pic Viewing in local mode?   0=Disable 1=Enable  */
  247.  
  248. Controls the ability to view pictures/play sounds & modules in local mode.
  249. If you don't have enough memory to spare, or you don't need this feature,
  250. then set this variable to 0.
  251.  
  252.  
  253. The 2nd line:
  254.  
  255.   rmo=0     /* Allow remote Sysop to use the Add to archives?  0=No 1=Yes   */
  256.  
  257. This one is used if you want the [A]dd function to be available in remote
  258. mode. I personally doesn't like remote's to have access to adding, since this
  259. function can be used to add thing like your keyfile to the archives.
  260.  
  261. NOTE: The [A]dd is ONLY available to users with Maint Access!!
  262.  
  263.  
  264. The 3rd line:
  265.  
  266.   fmem=200  /* How much MEM should ALWAYS be available to the system? (Kb)  */
  267.  
  268. This is how much memory that should ALWAYS be available to the system! So if
  269. you set this to 500, then FPAV will not unpack files if this limit is reached!
  270.  
  271.  
  272. The 4th line:
  273.  
  274.   maxsz=3000 /* How much of a text may a 'lamer' see, before break? (bytes) */
  275.  
  276. This is the size a 'lamer' (see 5th line) is allowed to see, when viewing a
  277. text file. When this size limit is reached the FPAV will abort viewing!
  278.  
  279. The 5th line:
  280.  
  281.   lamers=' 0 1 2 3 4 5 18 ' /* Access groups that may only see <maxsz> test */
  282.  
  283. These are the access groups that are defined as 'lamers' (see 4th line). Users
  284. NOT defined here are allowed to view the full textfile! If you don't want any
  285. access groups defined as 'lamers', then set this variable to '' (empty string)
  286. NOTE: Do NOT remove the leading and trailing space!
  287.  
  288.  
  289. The 6th line:
  290.  
  291.   dag=' 20 27 28 29 '     /* Access groups that may Download from archives  */
  292.  
  293. These are the access groups that are allowed to download files from within an
  294. archive. Remember that ALL files downloaded this way will be a FREE DOWNLOAD,
  295. so it's possible to download an entire archive for free!!  If you don't want 
  296. any access groups to be able to download from an archive, then set this 
  297. variable to '' (empty string)
  298. NOTE: Do NOT remove the leading and trailing space!
  299.  
  300.  
  301. Lines 7 to 13:
  302.  
  303.   spl='PlaySound'           /* IFF Sound player.  */
  304.   avi='PPShow NOFLICKER'    /* IFF Anim  player.  */
  305.   ivi='PPShow NOFLICKER'    /* IFF Pic viewer.    */
  306.   gvi='PPShow NOFLICKER'    /* GIF Pic viewer.    */
  307.   pvi='VT'                  /* PCX Pic viewer.    */
  308.   jvi='PPShow NOFLICKER'    /* JPEG Pic viewer.   */
  309.  
  310. These are the external programs used to view pictures/play sounds. Here you 
  311. can select your favorite viewer/player. NOTE: If you don't have a viewer/
  312. player for a specific type, then set the variable to ';'
  313.  
  314. The 14th line:
  315.  
  316.   guv='MultiView'            /* AmigaGuide viewer. */
  317.  
  318. This is the viewer you user to view AmigaGuide files with in local mode.
  319. (MultiView for OS3.x or AmigaGuide for Os2.x) NOTE: if you want to view your
  320. guide files, like normal textfiles in local mode, then set the variable to ''
  321. NOT ';' as with the other external programs.
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Known Bugs:
  328. ~~~~~~~~~~~
  329.  
  330.              When playing a Module in local mode, it activates the Delitracker
  331.              window. I would have prefered it to return to CNet window, but
  332.              I haven't found a way to do it. (YET!)
  333.  
  334.              Some files with ' or " will be impossible to view/delete due to
  335.              Arexx's way of handling variables!
  336.  
  337.              2.x Users Only!: The AmigaGuide program has a bug, when using 
  338.              public screens. It opens a requester everytime you view a guide
  339.              file! THIS IS NOT A BUG IN FPAV, BUT IN AMIGAGUIDE!!
  340.  
  341.  
  342.  
  343. History:
  344. ~~~~~~~~
  345.  
  346. I would like to thank my betatesters: Betasoft, Mr. Bean, Sir Sammy and
  347. Caveman for the great job they have done testing this program, and for
  348. their suggestions!
  349.      
  350. -FPAV v2.23
  351.   21 Feb 95 Added support for the LZX type of archives.
  352.  
  353. -FPAV v2.22
  354.   26 Jan 95 Moved the Delitracker setup to a variable. (I had hardcoded the
  355.             Delitracker path into the program!) thanks to Nightstalker for
  356.             for reporting this one! :)
  357.             Added support for viewing LightWave objects in local mode, using
  358.             the new ShowObj command (v2.1).
  359. -FPAV v2.21
  360.   31 Dec 94 Changed the Imagine Object viewing a bit, since the new version
  361.             2.0 of ShowObj support public screens. Now it will open on CNet's
  362.             screen instead of the Workbench.
  363.  
  364. -FPAV v2.20
  365.   14 Nov 94 Fixed a problem with directorys ending with a ":", also added the
  366.             FPES.rexx program, to allow Examining files in the SelectBuffer.
  367.  
  368. -FPAV v2.19
  369.   14 Nov 94 Fixed a problem with "Direct Access Subboards", with the
  370.             "Use CDROM temp dir" set to Yes. FPAV tried to delete the file
  371.             from the TEMPDIR, but CNET doesn't copy the file to the TEMPDIR,
  372.             when Examining or Typing, so it tried to delete the ORG. FILE!!
  373.             I think this is a bug in CNET, since it works perfectly, when the
  374.             subboard is NOT an "Direct Access Subboards". And the manual 
  375.             says that files will be copied to the TEMPDIR, when a file is
  376.             accessed. - Thanks to Thomas Beck for discovering this one!
  377.  
  378. -FPAV v2.18
  379.   15 Sep 94 Added support for viewing RIP-icons in local mode!
  380.  
  381. -FPAV v2.17
  382.   06 Sep 94 Added support for viewing AmigaGuide files from REMOTE!! Also
  383.             made it possible to use an external viewer, when viewing standard
  384.             ASCII files. (Thanks to mUb, for getting me the MoreText util.)
  385.  
  386. -FPAV v2.16
  387.   31 Aug 94 Fixed a small bug, where 'Amiga E source' showed up as a Sound-
  388.             Module! Also added the '%' to the list of 'Badchars' for the
  389.             [B] command.
  390.  
  391. -FPAV v2.15 (This version only released to those who sent me the POSTARD!!)
  392.   20 Jun 94 Added support for viewing MPEG anims (.MPG) and Icons (.info)
  393.             files in Local Mode.
  394.  
  395. -FPAV v2.14
  396.   19 Jun 94 Fixed a bug with CDROM temp path. The file in the CDROM temp dir
  397.             didn't get deleted after viewing, this is fixed now! Thanks to
  398.             Eduardo Torres for reporting this bug.
  399.  
  400. -FPAV v2.13
  401.   13 Jun 94 Added a routine to read the more prompt directly from BBSTEXT.
  402.             Cleaned up the [E]dit function, and changed the [A]dd function
  403.             so it can add files with full path.
  404.  
  405. -FPAV v2.12
  406.   01 Jun 94 Added another Sysop command! [E] which allows the Sysop to edit
  407.             textfiles INSIDE the archive.
  408.  
  409. -FPAV v2.11
  410.   06 Jun 94 Added a routine to check if a user is Suboperator in current 
  411.             subboard, and give him access to the Sysop Commands in FPAV.
  412.  
  413. -FPAV v2.10
  414.   01 Jun 94 Added a new Sysop command! [B] which adds the name of a file
  415.             INSIDE the archive, to a 'BBS-Ad StripList' in ENV: and ENVARC:
  416.             The 'BBS-Ad StripList' is then used by my special Transform
  417.             scripts, to delete those files next time it transforms the
  418.             archive! - Also fixed a bug in the unpack routine, that caused
  419.             FPAV to choke on 'un-displayable' file (like corrupted files).
  420.             This also caused a problem with the deleting of the Tempdir.
  421.             Fixed the Modplaying routine, to use the new DelitrackerII.
  422.  
  423. -FPAV v2.06
  424.   28 May 94 The problems with deleting the Tempdir in ram, is FINALLY fixed!!
  425.             Special thanks to Megachip for showing me what and how to fix this
  426.             problem!  (Had to do 2 'Call Pragma' instead on 1, but it works!!)
  427.             Now FPAV deletes ALL tempfiles after it has finished viewing!
  428.  
  429. -FPAV v2.05
  430.   24 May 94 The viewing of archives didn't work in Direct areas, this is now 
  431.             fixed! Thanks to Thomas Beck for reporting this one!
  432.  
  433. -FPAV v2.04
  434.   08 May 94 Fixed a major bug: If two users tried to use FPAV at EXACTLY the
  435.             same time, then the clipboard variables would get messed up, since
  436.             I didn't use a seperate variable for each port!! Also fixed a
  437.             small bug in the 'file not found' error routine!
  438.  
  439. -FPAV v2.03
  440.   23 Apr 94 Added support for GfxList by THJ. (A program to get info on
  441.             various picture/anim formats) - Also fixed a problem in the
  442.             Version routine! - Now the correct version of a file is displayed,
  443.             not the version of the file in memory/libs/devs. 
  444.   21 Apr 94 Hmm, while fixing the FileAttach Mail Bug, I created another BUG!!
  445.             The Viewing of archives inside archives, got a wrong path!! -
  446.             Thanks to Thomas for spotting this one!
  447.   20 Apr 94 Device files, didn't call the Version routine as it was supposed
  448.             to do! This is fixed now!  Added support for true viewing of 
  449.             AmigaGuide Documents in LOCAL mode!
  450.  
  451. -FPAV v2.0
  452.   16 Apr 94 Found and fixed a small bug. - When viewing FileAttach Mail, the
  453.             filename included the path, this caused FPAV to add a double path
  454.             to the name, so viewing was aborted! 
  455.   11 Apr 94 Removed TFMX Module playing, since it didn't work. Thanks to
  456.             Sir Sammy for finding this one! Added a ASCII percentage check
  457.             before displaying textfiles!
  458.   09 Apr 94 Another 'bug' fixed! - Now the Delitracker Window opens correctly
  459.             on the CNet screen, also when changing screen etc. Optimized the
  460.             Delitracker routine, and added GIFInfo support for archives.
  461.   07 Apr 94 Fixed a small bug - The 'Quick Mode' flag didn't get cleared,
  462.             when re-displaying the archive! Also fixed another 'bug' - when
  463.             trying to play a module, WITHOUT having Delitracker installed,
  464.             caused the program to 'hang' Cnet. - Thanks to Betasoft for 
  465.             discovering this one!!
  466.   04 Apr 94 Changed the Module player from MultiPlayer to DeliTracker.
  467.             DeliTracker had a better Arexx port, and more players available!
  468.             This way *ALL* module formats (those recognized by WhatIs) are
  469.             supported!!  Fixed a bug in the Local Download routine - Files
  470.             with paths names 'dissapeared' when copied to local path!
  471.             Now downloading from an archive is also supported for 'normal' 
  472.             users! The access groups for these users must be specified in 
  473.             the var DAG in FPAV.REXX. (NOTE: Users with ID access can ALWAYS
  474.             dl!)
  475.   02 Apr 94 Added Quick mode to normal viewmode (Sysops only) - Fixed a small
  476.             bug in the input parsing routine! - Now has support for different
  477.             picture viewers. - Oktalyzer Modules now supported!
  478.   01 Apr 94 Changed the local download mode to ask for download path, also
  479.             added a quick option to the Download option. As a request from
  480.             Sir Sammy and Caveman, FPAV now has the ability to show
  481.             'archives' with the extensions '.IFF/.GIF/JPG/.PCX' this allows
  482.             the sysop to view unpacked pictures in local mode!
  483.   31 Mar 94 Support for IFF anims (discovered that VT could view anims!!)
  484.             and added Xpk decrunching. - Now re-displaying the archive after
  485.             Adding or Deleting is supported! - Full re-displaying of the 
  486.             archive after viewing, is also suported in normal view mode. 
  487.   27 Mar 94 Added support for playing Module and IFF Sound Samples,
  488.             displaying GIF/IFF/PCX/JPEG pictures in local mode!
  489.   26 Mar 94 TOTALLY REWRITTEN! - LHA and ZIP now in one program! - Checks for
  490.             available mem, before unpacking! - Extended range selection. +
  491.             Lots of minor bugfixes!
  492.  
  493. -FPAV v1.0
  494.   26 Mar 94 No history for previous revisions.
  495.  
  496.  
  497.  
  498. Direct any bug reports and/or comments to:
  499.  
  500.         PMK/Peter Klein 
  501.         Flux Point Amiga BBS   (My BBS!)
  502.         +45 3526 2527
  503.         USR 16800 Dual Standard
  504.  
  505.     Or write to me in the following NETS:
  506.  
  507.         FIDO     2:235/202.0
  508.         CLink    912:2000/4.0
  509.         AmigaNet 39:141/139.0
  510.  
  511.     You can also leave me mail on Future World (handle: PMK), but I don't
  512.     call too often, so a response may be slow.
  513.